home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / u_man / cat1 / pmrun.z / pmrun
Text File  |  1998-10-20  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4. PPPPMMMMRRRRUUUUNNNN((((1111))))                                                              PPPPMMMMRRRRUUUUNNNN((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppmmmmrrrruuuunnnn - graphical utility for entering PCP command line arguments
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ppppccccpppp////bbbbiiiinnnn////ppppmmmmrrrruuuunnnn [----aaaa _a_r_c_h_i_v_e] [----hhhh _h_o_s_t] [----SSSS _s_t_a_r_t] [----TTTT _f_i_n_i_s_h] [----tttt
  13.      _d_e_l_t_a] [----xxxx _t_e_x_t] [----yyyy _t_e_x_t] _c_o_m_m_a_n_d [_s_p_e_c_i_f_i_c_a_t_i_o_n_s ...]
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      ppppmmmmrrrruuuunnnn is a configurable utility for launching applications within the
  17.      Performance Co-Pilot (PCP) framework.  It is primarily a visual interface
  18.      to the more frequently used command line arguments for each tool, and is
  19.      intended as an aid in launching tools from the desktop.
  20.  
  21.      ppppmmmmrrrruuuunnnn is based on the llllaaaauuuunnnncccchhhh(1) utility, and also understands a small set
  22.      of the common PCP command line arguments, and contains knowledge of the
  23.      semantics of these arguments.  For example, the arguments for archives
  24.      (-a) and hosts (-h) are common to many of the PCP monitor tools, and are
  25.      also mutually exclusive arguments - this relationship is enforced by
  26.      ppppmmmmrrrruuuunnnn, while still allowing either type of metric source to be specified.
  27.      ppppmmmmrrrruuuunnnn must be run with a _c_o_m_m_a_n_d (must be an executable file) which is to
  28.      be executed when either the ``OK'' or ``Apply'' button is pressed.
  29.  
  30.      The optional _s_p_e_c_i_f_i_c_a_t_i_o_n_s allow additional launch arguments to be
  31.      mapped to input fields for user completion.  Again, this is intended to
  32.      provide a more obvious, self-explanatory interface to the launched
  33.      application than is provided by the command line.
  34.  
  35.      The _o_p_t_i_o_n_s control the specific arguments which are presented to the
  36.      launched tool when either the ``OK'' or ``Apply'' button is pressed.
  37.  
  38.      ----aaaa   Creates a finder widget which allows an archive filename to be
  39.           entered and subsequently passed to the launched tool via its own -a
  40.           argument.  The default value presented in the finder will be
  41.           _a_r_c_h_i_v_e, which can be the empty string (_a_r_c_h_i_v_e is required if ppppmmmmrrrruuuunnnn
  42.           is given the -a argument, even if an empty string enclosed by quotes
  43.           is all that is used).
  44.  
  45.      ----hhhh   Creates a finder widget which allows a hostname to be entered and
  46.           passed to the launched tool via its own -h argument.  The default
  47.           value in the finder will be _h_o_s_t.
  48.  
  49.      ----SSSS   Creates a text field which allows the _s_t_a_r_t time for metric fetches
  50.           from an archive to be entered.  This field will not be editable if
  51.           both the -h and -a arguments have been presented to ppppmmmmrrrruuuunnnn and the
  52.           ``Host'' toggle button is currently set.  The times entered in this
  53.           text field validated according to the syntax rules described in
  54.           PPPPCCCCPPPPIIIInnnnttttrrrroooo(1) before being passed on to the launched tool.
  55.  
  56.      ----TTTT   Similar to the -S argument, but allows the archive _f_i_n_i_s_h time to be
  57.           entered.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. PPPPMMMMRRRRUUUUNNNN((((1111))))                                                              PPPPMMMMRRRRUUUUNNNN((((1111))))
  71.  
  72.  
  73.  
  74.      ----tttt   Creates a text field and an associated time-units selection menu.
  75.           This allows the sample interval at which performance metrics will be
  76.           fetched from the metrics source to be specified.  The interval
  77.           argument follows the syntax described in PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), and in the
  78.           simplest form may be an unsigned integer (the implied units are
  79.           seconds).  The default is 2.0 seconds.
  80.  
  81.      ----xxxx   The _t_e_x_t following this argument will be prepended to the launched
  82.           _c_o_m_m_a_n_d before it is executed.
  83.  
  84.      ----yyyy   The _t_e_x_t following this argument will be appended to the launched
  85.           _c_o_m_m_a_n_d before it is executed.
  86.  
  87. SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN LLLLAAAANNNNGGGGUUUUAAAAGGGGEEEE
  88.      The language used to recognize the _s_p_e_c_i_f_i_c_a_t_i_o_n arguments to ppppmmmmrrrruuuunnnn is
  89.      designed to be simple and easily extended (programmatically) should the
  90.      need for different argument input mechanisms arise.
  91.  
  92.      The general format for these arguments is a ``|'' separated string, with
  93.      the first argument distinguishing the user-interface element (type) which
  94.      is to be created.  Currently the only supported specification type is for
  95.      text fields, and the remaining tokens are as follows:
  96.  
  97.      _t_e_x_t|_f_l_a_g|_l_a_b_e_l|_d_e_f_a_u_l_t
  98.  
  99.      The _t_e_x_t token identifies this as a text field.  _f_l_a_g is the command line
  100.      flag to pass to the launched application (a ``-'' will be prepended to
  101.      this by ppppmmmmrrrruuuunnnn) when a value has been entered into this text field.  _l_a_b_e_l
  102.      is the label associated with this text field, and _d_e_f_a_u_l_t is the string
  103.      displayed by default in the text field.
  104.  
  105. FFFFIIIILLLLEEEESSSS
  106.      ////uuuusssseeee////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////PPPPmmmmRRRRuuuunnnn
  107.                              application resources
  108.  
  109. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  110.      ffffffffttttrrrr(1), iiiiccccoooonnnnbbbbooooooookkkk(1), llllaaaauuuunnnncccchhhh(1) and PPPPCCCCPPPPIIIInnnnttttrrrroooo(1).
  111.  
  112. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  113.      All error conditions encountered will be reported via an error dialog,
  114.      and are intended to be self-explanatory.
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.